PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Control Manager >

Programming With the Mac OS 8.5 Control Manager

SetControl32BitValue

Changes the current setting of a control and redraws it accordingly.

pascal void SetControl32BitValue (
                     ControlHandle theControl,
                     SInt32 newValue);
theControl
A value of type ControlHandle . Pass a handle to the control whose current setting you wish to change.
newValue
A signed 32-bit integer. Pass a value specifying the new setting of the control. If the specified value is less than the minimum setting for the control, SetControl32BitValue sets the current setting of the control to its minimum setting. If the specified value is greater than the maximum setting, SetControl32BitValue sets the control to its maximum.

DISCUSSION

Your application may use the SetControl32BitValue function to set a 32-bit value as the current setting for a control.


SPECIAL CONSIDERATIONS

If your application uses a 32-bit control value, it should not attempt to obtain this value by calling the pre-Mac OS 8.5 function GetControlValue or by accessing the contrlValue field of the ControlRecord structure, because the stored 16-bit value will not accurately reflect the current 32-bit control value. Instead, use the function GetControl32BitValue .


VERSION NOTES

Available with Mac OS 8.5 and later.


SEE ALSO

"Settings Values for Standard Controls" in Mac OS 8 Control Manager Reference .

© 1999 Apple Computer, Inc. — (Last Updated 20 Jan 99)